package com.sheyu.mall.product.config;

/**
 * @author sheyu
 * @date 2020/7/29 10:14 下午
 */

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * Swagger2生成文档
 */
@Configuration
@EnableSwagger2
public class Swagger2 {

    // http://localhost:8088/swagger-ui.html    原路径
    // http://localhost:8088/doc.html    换肤之后的路径

    // 配置Swagger2核心配置
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)  // 指定API类型为SWAGGER_2
                .apiInfo(apiInfo())                     // 定义API文档汇总信息
                .select()
                .apis(RequestHandlerSelectors
                        .basePackage("com.sheyu.mall.product.app"))// 指定controller包，用于生成api的controller包
                .paths(PathSelectors.any())             // 所有controller
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("mall电商平台接口API")          // 文档页标题
                .contact(new Contact("sheyu",
                        "sheyu.com",
                        "sheyu@163.com"))     // 联系人信息
                .description("电商提供的API文档")   // 详细信息
                .version("1.0.1")// 文档版本号
                .termsOfServiceUrl("https://www.sheyu.com")// 网站地址
                .build();
    }

}
